JCSM Shareware Collection 1996 September/JCSM Shareware Collection (JCS Distribution) (September 1996).ISO/medhelth/slim303c.zip/4.ZIP/CALTAB.DOC

Text File | 1995-02-18 | 12KB | 247 lines

                                                          January 18, 1995


                        *************************
                        *                       *
                        *     CALTAB Rev 1.41    *
*************************                       *************************
                        *        (c) 1995       *
                        *                       *
                        *************************

                                  by

                          George D. Summers
                          2117 Coon Club Road
                          Westminster, MD 21157

                          Phone [phone]
                            (Usually  available between 5:30 and 9:30 pm on
                            weekdays,   between   7:00   and  10:00  pm  on
                            Saturday,  and  between  2:00  and  6:00  pm on
                            Sunday).

                          CIS 76276,564
                          Internet:[e-mail]

CALTAB is the food (and exercise) table editor for SLIMMER Rev 3.0  and  is
only  available  to  REGISTERED users of SLIMMER.  Please do not distribute
file CALTAB.EXE to others.

CALTAB performs the following functions:

      1. The food table files can be edited.
      2. New items can be added to the food tables.
      3. Items can be deleted from the food tables.
      4. The food table files can be sorted.
      5. The food table files can be converted to print files.
      6. The food table menu can be edited.
Most of the data listed in the food tables is obtained from the following
reference:

      Bowes and Church's
      FOOD VALUES OF PORTIONS COMMONLY USED
      15th edition
      revised by Jean A. T. Pennington, Ph.D., R.D.
      Harper & Row, Publishers, New York

If you wish to add to the food  tables,  the  above  reference  is  readily
available  for  purchase  in  8-1/2"  x 11" paperback and provides data for
many more items than those included in  the  SLIMMER  Rev  3.0  food  table
database. Very few name brands were included in the SLIMMER database. Since
individual tastes vary considerably, it was assumed that individuals  could
easily add the name brand items of their choice.  Additional references are
found in SLIMMER.DOC.

Note  that sometimes there are blank entries in the food tables.
When this occurs, the correct assumption is that the value is unknown ( not
that the value is 0).

                           PROGRAM USAGE

CALTAB,  the Food Table Editor for registered SLIMMER users, is called from
the main program menu within SLIMMER Rev 3.0 and does not  operate  on  its
own.  A default set of food tables with the file  extension  .DAT  such  as
BEV.DAT  etc is supplied with SLIMMER.  These files have been designated as
read-only files (you can't edit them).  When  you  select  "T  calTab  food
table  editor" from the main SLIMMER menu for the first time, a set of food
table  files  will  be  initialized  for you by  copying  the  *.DAT  files
into  your  unique  food  table files.  These unique files will end with an
extension that is either the first three letters of your name, or will be a
_ plus the first 2 letters of your name.  In my case, n$ = GEORGE  and  the
food  table  extensions ext$ would all be .GEO such as BEV.GEO etc. In  the
event  that the first 3 letters of your name conflicts with extensions used
by DOS or by the program (such as EXE, BAT, CAL, or  SLM)  then  they  will
become  ._EX,  ._BA, ._CA, or ._SL respectively.  The purpose of the unique
extensions is to allow multiple users to use  CALTAB  and  SLIMMER  without
modifying  each  other's  food table files. SLIMMER and CALTAB will then be
able to co-exist in the same subdirectory.

NOTE  that  if two people with the same name (such as JOHN etc) use SLIMMER
(and therefore CALTAB) their data files will conflict. In  this  case  they
may  want  to use nicknames or change their login names to 1JOHN, 2JOHN etc
if they want to have a unique set of data.

The main CALTAB menu lets you select the food  table  of  your  choice  for
editing.  All  other  program  features (sort and print file) are available
when the food table file is displayed on the screen  and  the  "Enter  Line
Item  # to EDIT" box is visible. Pressing function key F1 will show you the
list of functions available to you:

                       HELP FOR FOOD EDIT ROUTINE

                      F2              Save file
                      F3              Delete item
                      F4              Sort List
                      F6              Send List to Print File
                      home            Page 1
                      end             Last page
                      Pg Dn           Next page
                      Pg Up           Previous page
                      Esc             Quit editing
                      xxx             Edit line number

             note: If line number selected is on the screen, then
             the edit mode is invoked.  If the number is  not  on
             the screen, then the page containing the line number
             will be displayed.

Whenever  a  data  file  is edited, the original .ext$ file is renamed to a
.DAA file and is the backup file in case there is  an  accidental  loss  of
power or unexpected error during your editing session.  If this occurs, you
can restore your original file with the command:

                     copy fn.DAA fn.ext$

where fn is the name of the file you are editing, and ext$ is  your  unique
file  extension  (see  above).  To  see  a list of the .DAA files, type the
following command:

                     dir *.DAA

                            SAVING FILES

As  is the case in any editing session, it is wise to save your file often.
This can be done by pressing F2  whenever  "Enter  Line  Item  #  to  EDIT"
appears in the box at the bottom of your screen. If you have saved  a  file
during  the  editing  session and then experience a loss of power or error,
the .ext$ file will be the most recent file and you will only have lost the
changes you made after pressing F2.

                            SORT ROUTINE

The  sort  routine  will  sort items according to the order of the standard
ASCII table. The order will be comma (,), period (.), then  the  numbers  0
through  9,  then the upper case letters (A through Z), followed finally by
the lower case letters (a through z) an the tittle(~). If  you  have  items
that  that you want to have ordered differently than the standard sort, you
can rename them so that the sort routine would place them  in  a  different
location  in  the  list. For example, if an item must be first in the list,
you could start the description with a period (.) to ensure that  it  would
be listed first. If the item needs to be last, the tittle (~) could be used
to ensure that the item is last in the list. Feel free to experiment a bit.
The ASCII table is readily available in most programming manuals.

                            EDITING THE FOOD TABLE MENU

Selecting  the  last  line in the main menu places you in the edit mode for
the menus and file names. When you then select a menu line, you'll be  able
to edit first the description, then the file name for the data. To delete a
line  in  the  menu,  you  can  either hold down the <DEL> key for both the
description and the file name until the characters disappear, or  else  use
the  <CTRL><END> command. To add lines, go to any blank line and enter both
a   description and a file name. BLANKING OUT LINES WITH THE SPACE BAR WILL
CAUSE PROBLEMS..... Use <CTRL><END> instead.

CAUTION - When you change a file name in the menu editor,  unless  the  new
file  name  corresponds  to  an  existing file, you will have the condition
described below under MISSING .ext$ FILES


                            MISSING .ext$ FILES

When  you  try  to  edit  a XXX.ext$ file that is missing, (XXX = BEV,  etc
and  ext$  is  your  unique extension) CALTAB will create an empty file and
name it XXX.ext$ and you will be able to enter data  into  it.  This  is  a
useful  feature  if  you  want  to  start from scratch with any of the food
tables.  You could rename the .ext$ file in question to anything other than
.ext$, and CALTAB would create the empty .ext$ file.  This  feature  always
happens  when  you first select the "Special items for n$" category, (n$ is
your name), and allows a separate file to be generated for each  user.   If
the  .ext$  file is really missing and you don't want an empty .ext file to
be formed, you can either copy the missing  file  into  the  directory  and
overwrite   the   empty  file  (in  DOS),  or  change  the  file  name  (in
CALTAB's menu editor) to one that exists.

                            USING CALTAB WITH SLIMMER

CALTAB Rev 1.4 (Jan 1, 1991) and onward is written to co-exist with SLIMMER
and  should  be  located in the SLIM30 subdirectory. Note that SLIMMER will
NOT recognize you as a registered user until you run CALTAB for  the  first
time.   This  will  create the n$.NDX file that SLIMMER looks for to see if
you are registered...


                            CALTAB REVISION HISTORY

CALTAB  Rev  1.3  was  distributed  to registered SLIMMER users between the
dates of April 4, 1990 and December 23, 1990. This version  of  CALTAB  was
designed  as  a  stand-alone program and worked exclusively with *.DAT food
table files.

CALTAB Rev 1.4  is distributed to registered SLIMMER from December 24, 1990
and  onward.  This  version  is designed to operate only as called from the
main SLIMMER Rev 3.0 main menu  and  will  not  operate  independently.  It
creates data files with unique extensions (ext$) for each user.

CALTAB Rev 1.41 is distributed from June 15, 1993 onward.  It adds LaserJet
printers to the existing dot matrix and postscript printers.

For  those users that have experimented with CALTAB Rev 1.3,  have  created
their own *.DAT files, and want to use those files -  here's what should be
done: Go to your existing CALTAB  subdirectory (cd\caltab)  and  issue  the
command

                            COPY *.DAT *.ext$

, where ext$ is the first 3 letters of your name, or if it  coincides  with
one of the names below:

BAK   BAS   BAT   BIN   CAL   CFG   COM   DAA   DAT   EXE   ICO   INC   OVL
NDD   NDX   PRT   PS    SLM   T01   ICO   ZIP

it should be a "_" plus the first two letters of your name.

(Needless  to  say,  if your name is SLIM your name has already been taken.
SLIM is the person whose data files are included with SLIMMER as  examples.
In this case, use a different or unique name such as 1SLIM etc.)

The  COPY  *.DAT  *.ext$  (you  supply  the  ext$ value from above) command
copies ALL the *.DAT files to files with your unique extension  ext$.  Your
data  files are now a subset of these .ext$ files. Send a directory list of
your unique files within CALTAB to your printer with the command:

                  DIR *.ext$ > LPT1  (again, you supply ext$)

Determine which of these files are your unique files by running CALTAB (rev
1.3) and selecting the last line in the main menu to view your list of file
names.  Compare this list with the one you just  printed  out  (ignore  the
file  extensions  for  now).   As  you leave CALTAB select YES to create an
index file. Delete the files which don't coincide on  the  two  lists  with
the command:

                  DEL fn.ext$ (you supply both fn and ext$)

Finally you can copy your files  into  the  SLIM30  subdirectory  with  the
commands:

                 COPY n$.NDX path:\SLIM30
                 COPY *.ext$ path:\SLIM30

where n$ is your name, path is the drive with your SLIM30 subdirectory, and
ext$ is your extension from above.